[Top] [Prev] [Next] [Bottom] [Contents]

SutNewList

Returns a pSutList, a pointer to a SutList structure.

Synopsis

#include "SutList.h"
pSutList SutNewList();

Arguments

None.

Return Values

Returns a pSutList and a pointer to a SutList structure.

Description

SutNewList returns a pSutList, a pointer to a SutList structure. The SutList structure and related functions manage a dynamically sized array of void pointers which can be used as a generic container for C/C++ programmers. The list must be deallocated with SutDeleteList() or SutDestroyList().

Caution is needed in using SutDestroyList to deallocate the elements. If the elements contain pointers to other heap items these will not be deallocated. If the elements are non-heap memory, a disaster will probably occur.

Example

#include "SutList.h"
#include <stdio.h>
pSutList list;
int i, size;
char *str;
char* str1 = "Hello";
char* str2 = "World";
list = SutNewList();
SutAddList(list, str1);
SutAddList(list, str2);
size = SutSizList(list);
for (i=0; i<size; i++)
{
	str = (char*) SutGetNList(list, i);
	fprintf(stderr, "%s\n", str);
}
SutDeleteList(list);

See Also



[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.